home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / C / Applications / Transcript 1.0b1 / Transcript ReadMe < prev   
Text File  |  1996-06-15  |  3KB  |  42 lines

  1.            TRANSCRIPT
  2.                   v1.0b1
  3.                 15 June, 1996
  4.  
  5. Copyright © 1996 Christopher E. Hyde.  All rights reserved.
  6.  
  7. Written by:  Christopher E. Hyde
  8. Email:       drjekyll@hylight.demon.co.uk
  9. Address:     HyLight Limited
  10.           25 Carson Road
  11.           London  E16 4BD
  12.           England (UK)
  13.  
  14. This is the first public release of Transcript, a simple AppleScript-aware text display server-application.  Transcript displays text from other applications which may then be copied or saved to a file.
  15.  
  16. Quite simply Transcript is a debugging utility that enables programs written in C & C++ to ‘printf’ to a scrolling window without having to add standard I/O type windows to the program itself.  Additionally Transcript allows debugging code to be left in test releases of applications which then only display the information if Transcript is running.  On top of all of that Transcript can also be used from within AppleScript.
  17.  
  18. The Transcript application is supplied as a fat binary and is compatible with Macintoshes and Power Macintoshes from SEs upwards and System 7.0 or later.  It requires only 100K-140K of RAM to run and is compatible with RAM Doubler.
  19.  
  20. Transcript is free and may be distributed freely provided that it is distributed intact and complete.  If you have any comments, suggestions, questions or offers of money or work please contact me via the above addresses.
  21.  
  22. THIS SOFTWARE IS PROVIDED “AS IS” AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  23.  
  24. Usage
  25. C source code is supplied for a simple ‘Hello World!’ application and the ‘DbgPrintF’ function which is compatible with MPW 3.4.2’s SC[pp] & MrC[pp] and should also work with Symantec C++, Think C & Code Warrior with little or no modification.  Also the file ‘Test Echo’ contains an example of how to use Transcript from within AppleScript.
  26.  
  27. To build the ‘Hello World!’ application:
  28.     • launch MPW,
  29.     • set the current directory to the ‘Hello World ƒ’ folder,
  30.     • type ‘BuildHelloWorld ø ’
  31.  
  32. To use Transcript from your C/C++ program you must compile the file ‘DbgPrintF.c’ and link it into your program along with the appropriate library (StdCLib/ANSI/ANSI—small++ or whichever contains the ‘vsprintf’ function that ‘DbgPrintF’ uses).  Then include ‘DbgPrintF.h’ in your source file, and insert calls to
  33.     DbgPrintF(const char* format, ...);
  34. wherever you like.
  35.  
  36. Note: the first time that the ‘DbgPrintF’ function is called it initialises itself.  This includes allocating a 4K buffer to hold the output of ‘vsprintf’.  If you need to print longer strings then you must change ‘DbgPrintF.c’.
  37.  
  38. Advertisement
  39. Contact Christopher E. Hyde at drjekyll@hylight.demon.co.uk for all your Macintosh custom software development and user interface design needs.
  40.  
  41. C/C++, Assembler, PostScript, MacApp, HyperCard & AppleScript.
  42.